I just remembered something (which would make the "definition of done" for this issue a bit more work) - we should probably also include instructions for how to update to the correct versions of nargo and aztec-nr, and how the user should update their own project (e.g. updating their own project's Nargo file) to adjust to the new nargo and aztec-nr versions. We should also provide a link to our release changelogs, so that a user can read about changes that they might need to make to their contract, to make it work with the new nargo/aztec-nr.

There's a relevant discussion here, where @spalladino provides some good insight:
https://aztecprotocol.slack.com/archives/C03P17YHVK8/p1694597144800569?thread_ts=1694542462.519609&cid=C03P17YHVK8

It might even be worth creating a new file dev-docs/getting-started/updating.md, because there's so much to explain. All of the explanations you've already done could be moved to this new file instead, perhaps?

Disabled auto-merge, in light of my comment above (sorry :) )

@iAmMichaelConnor makes sense. Will do the changes 👍